home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / qprn112.zip / READER.DOC < prev    next >
Text File  |  1994-05-12  |  15KB  |  268 lines
  1.   QWKPRUNE can be used as a "preprocessor" for many QWK readers.  If the
  2.   reader lets you replace the name of your unpacker with a batch file, you
  3.   should be able to use QWKPRUNE in this manner.  If it doesn't, you may be
  4.   able to use PARM.EXE to call a batch file.
  5.  
  6.   Create a prune file for each BBS you want to filter messages from.  Each
  7.   prune file must be named BBSID.PRN.  The files must be located in the
  8.   same directory as QWKPRUNE.EXE, unless you set the PRUNE option in the
  9.   configuration file, or specify a directory on the line that calls
  10.   QWKPRUNE.  BBSID should be the name the board's mail door gives to QWK
  11.   packets. So if a BBS creates packets named ABC.QWK, the prune file should
  12.   be named ABC.PRN.  QWKPRUNE reads the BBSID from CONTROL.DAT, so it can
  13.   find the correct prune file even if a packet has been renamed.  If
  14.   there's no prune file for a BBS, (R) and Re: prefixes, user-defined
  15.   prefixes, and leading whitespace will still be stripped from the subject
  16.   lines of the messages.
  17.  
  18.   Extract the correct batch file from the distribution archive, place it in
  19.   the directory where your reader is located, and edit it to fit your
  20.   configuration.  If your reader isn't listed below, try using UNPACK.BAT.
  21.   Once you have the batch file working, delete the REM statements to speed
  22.   up processing.  You should also extract PARMSCAN.EXE, and place it in the
  23.   directory where your reader is located, or a directory on your DOS path.
  24.   
  25.   I've tested this with SLMR/OLX 2.x, EZ-RDR 1.37-1.39, DeLuxe 1.2x,
  26.   1stReader 1.01+, KingQWK 1.00 and 1.05, QWKMerge 1.05, Jabber 1.1+,
  27.   Session Manager 1.06, MegaMail 2.10, Power-QWK 2.14, Speed Read 1.20+,
  28.   Blue Wave 2.1x, RoboMail, MikeMayl, and Camster.
  29.  
  30.  
  31.                                 SLMR/OLX 2.x
  32.                                    -----
  33.   Use UNPACK.BAT.  SLMR and OLX change to their work directory, so there's
  34.   no need to specify its location in the batch file. SLMR and OLX can call
  35.   batch files directly.
  36.  
  37.                               EZ-RDR 1.37-1.39
  38.                                    -----
  39.   Use UNPACK.BAT.  EZ-RDR creates a directory called WORK below the EZ-RDR
  40.   directory defined in its configuration.  It changes to this directory, so
  41.   references to the work directory can be removed from the batch file.
  42.   EZ-RDR doesn't remember what directory it changed from, so you'll have
  43.   to give a path to UNPACK.BAT when reconfiguring EZ.  EZ-RDR can call
  44.   batch files directly.
  45.  
  46.   When EZ-RDR saves your place in a QWK, it alters the .NDX files and
  47.   re-archives them, but doesn't re-archive MESSAGES.DAT.  As a matter of
  48.   fact, it appears to delete MESSAGES.DAT before inserting the bookmarks
  49.   into the QWK packet.  If you want to have EZ-RDR save your place, insert
  50.   the line "copy messages.dat messages.bak" (without quotes) into
  51.   UNPACK.BAT just below the line that runs QWKPRUNE.  You'll also need to
  52.   reconfigure EZ-RDR to use EZ-PACK.BAT to call your packer.
  53.  
  54.   Running a batch file while swapped to EMS may interfere with the display
  55.   in EZ-RDR 1.37's DOS window.  It appears that the QWK packet is still
  56.   processed correctly, you just can't follow the process.
  57.  
  58.                                 DeLuxe 1.2x
  59.                                    -----
  60.   Use UNPACK.BAT.  DeLuxe doesn't change to the Q-WORK directory, so you'll
  61.   have to specify its location in the batch file.  DeLuxe can call batch
  62.   files directly.  If you tell DeLuxe to insert a bookmark, it will
  63.   recreate the QWK, saving any changes that were made.  Note: you can
  64.   represent the Q-WORK directory as %W\Q-WORK.  If you do this, enter the
  65.   batch file name as "BAT:UNPACK.BAT" (without quotes) when reconfiguring
  66.   DeLuxe.
  67.  
  68.                                  1stReader
  69.                                    -----
  70.   Copy FIRST.BAT to the directory where 1stReader is located and rename it
  71.   $$INTRO.BAT.  If you already have an $$INTRO.BAT, insert the line
  72.   "qwkprune /m%2" (without quotes) into it.  %2 represents the the work
  73.   directory defined in 1stReader's setup.
  74.  
  75.   If the "Use Bookmark" switch in 1stReader's setup is ON, you can usually
  76.   save any changes by telling 1stReader that you want to insert a bookmark.
  77.   According to Mark Herring, 1stReader won't repack QWK packets that came
  78.   from a Qmail door with option #21 turned on.  You can also use SAVEQWK
  79.   (see ADDON.DOC) to save the changes.
  80.  
  81.   Note that, if $$INTRO.BAT exists, 1stReader automatically runs it after
  82.   the QWK is unpacked.  There's no need to change 1stReader's setup.
  83.  
  84.                                   KingQWK
  85.                                    -----
  86.   Use UNPACK.BAT.  If you're using version 1.05, and KingQWK is not
  87.   configured to swap, you can enter the name as "UNPACK.BAT" (without
  88.   quotes).  Otherwise, use COMMAND /C or PARM.  If KingQWK is configured to
  89.   swap, enter these names as COMMAND.COM /C or PARM.EXE.  KingQWK doesn't
  90.   change to its work directory when unpacking a QWK, so you'll have to
  91.   specify it in UNPACK.BAT.  Users of version 1.05 can save changes by
  92.   killing a message in KingQWK, then unkilling it. It appears that this is
  93.   enough to get KingQWK to ask if you want to delete killed messages from
  94.   the QWK packet.
  95.  
  96.   Versions of KingQWK prior to 1.05 will automatically re-archive
  97.   MESSAGES.DAT if it's been changed, even if it wasn't changed by KingQWK.
  98.   However, the changed .NDX files won't be re-archived.  You should
  99.   reconfigure KingQWK to use KQ-PACK.BAT to call your unpacker.
  100.  
  101.                                   QWKMerge
  102.                                    -----
  103.   Use QWKM.BAT.  If you're using version 1.05, and QWKMerge is not
  104.   configured to swap, you can enter the name as "QWKM.BAT" (without quotes)
  105.   Otherwise, use COMMAND /C or PARM.  If QWKMerge is configured to swap,
  106.   enter these names as COMMAND.COM /C or PARM.EXE.
  107.  
  108.   Thanks to Mike King for mentioning that version 1.05 of KingQWK and
  109.   QWKMerge can call batch files directly under some conditions.
  110.  
  111.   The configuration programs for KingQWK and QWKMerge don't allow the
  112.   command lines for packers and unpackers to be very long.  You may want to
  113.   give the batch files shorter names.  If you use PARM, you should be able
  114.   to fit the command lines for most unpackers into the allotted space, though
  115.   you may need to give PARM.EXE a shorter name.  If you can't fit the name
  116.   of an unpacker into the available space, make a copy of the batch file,
  117.   and place the name of the unpacker, along with any needed switches in
  118.   front of the "%1 %2 %3 %4 %5 %6 %7 %8 %9" line.
  119.  
  120.   Note: On some systems, KingQWK and QWKmerge may lock up when swapping in
  121.   from EMS.  Swapping to disk or XMS works OK.  This doesn't appear to be
  122.   related to QWKPRUNE.  At least, it happens whether or not QWKPRUNE is
  123.   being run while KingQWK or QWKMerge is swapped.
  124.  
  125.   If you have this problem, turn swapping off and try using a third-party
  126.   swapper.  I've gotten SHROOM to work with the "-t *" switch provided that
  127.   packers and unpackers are entered without extensions.  I've also had
  128.   success using SWAPDOS to swap to EMS.
  129.  
  130.                                 Jabber 1.1+
  131.                                    -----
  132.   Use UNPACK.BAT.  When editing the unpacking commands in Jabber's
  133.   configuration file, enter the name as "UNPACK.BAT" (without quotes).
  134.   Note that the .BAT extension must be given, or Jabber won't know that
  135.   it's to call a batch file.   Thanks to John Erickson for pointing this
  136.   out.  (According to Lawrence Johnstone, 4DOS users may use the .BTM
  137.   extension.  Thanks, Lawrence.)
  138.  
  139.   Also, the command lines for unpackers must not contain slashes or
  140.   backslashes.  It appears that confuses Jabber, and causes the parameters
  141.   to be passed incorrectly.
  142.  
  143.   Jabber changes to its work directory when unpacking a QWK, so references
  144.   to the work directory can be removed from UNPACK.BAT.
  145.  
  146.                             Session Manager 1.06
  147.                                    -----
  148.   Use SMAN.BAT.  Session Manager can call batch files directly.  Its basic
  149.   configuration routines d